package cn.iocoder.yudao.module.wms.service.stockdetail;

import java.math.BigDecimal;
import java.util.*;
import cn.iocoder.yudao.module.wms.controller.admin.stockdetail.vo.*;
import cn.iocoder.yudao.module.wms.dal.dataobject.stockdetail.StockDetailDO;
import cn.iocoder.yudao.framework.common.pojo.PageResult;
import cn.iocoder.yudao.framework.common.pojo.PageParam;

import javax.validation.Valid;

/**
 * 库存明细 Service 接口
 *
 * @author 芋道源码
 */
public interface StockDetailService {

    /**
     * 创建库存明细
     *
     * @param createReqVO 创建信息
     * @return 编号
     */
    Long createStockDetail(@Valid StockDetailSaveReqVO createReqVO);

    /**
     * 减少库存
     * @param id
     * @param qty
     */
    void updateStockDetail(Long id, BigDecimal qty);

    /**
     * 更新库存明细
     *
     * @param updateReqVO 更新信息
     */
    void updateStockDetail(@Valid StockDetailSaveReqVO updateReqVO);

    /**
     * 删除库存明细
     *
     * @param id 编号
     */
    void deleteStockDetail(Long id);

    /**
     * 获得库存明细
     *
     * @param id 编号
     * @return 库存明细
     */
    StockDetailDO getStockDetail(Long id);

    /**
     * 获得库存明细分页
     *
     * @param pageReqVO 分页查询
     * @return 库存明细分页
     */
    PageResult<StockDetailDO> getStockDetailPage(StockDetailPageReqVO pageReqVO);

    /**
     * 根据产品、仓库、库位查询库存明细
     * @param productId
     * @param warehouseId
     * @param positionId
     * @return
     */
    List<StockDetailDO> getStockDetailByProductWarehousePosition(Long productId, Long warehouseId, Long positionId);

    /**
     * 根据单据编号查询库存明细
     * @param docId
     * @param docCode
     * @return
     */
    List<StockDetailDO> getStockDetailByDocCode(Long docId, String docCode);
}